home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 1 / Gold Medal Software Volume 1 (Gold Medal) (1994).iso / graphics / pv3db1.arj / PV3DB191.EXE / PV3DB191.DOC < prev    next >
Text File  |  1993-10-10  |  20KB  |  524 lines
  1. o PV3D B1.91 and POVRAY 2.00 / VIVID 2.00 output
  2. ============================================================================
  3.  
  4. The version 1.91  include a lot news functions since the version 1.00.
  5. Sorry but I have no time to make the english documentation and now
  6. POVRAY 2.00 was available.
  7.  
  8. I send this version B1.91 of PV3D to help you to use POVRAY 2.0 and
  9. VIVID 2.00 trought PV3D now.
  10.  
  11. For the news user of PV3D read in first the PV3D V1.00 documentation include
  12. in the file PV3DV100.DOC and after read this file to understand the changes.
  13.  
  14. I think the US documentation of PV3D was available in a short time but after 
  15. the French documentation (actually 110 pages at the 8 Oct 93).
  16.  
  17. >>>Actuellement une documentation en français de 110 pages existe et est en
  18. >>>cours d'amélioration constante. Elle est disponible avec le package license.
  19. >>>Voir la fin de ce texte. Merci
  20.  
  21. II put here some information to help you to use the POVRAY 2.00 and VIVID 2.00
  22. output and the new PV3D features.
  23.  
  24. o PV3D upgrade
  25. ============================================================================
  26.  
  27. Logiquely I put the last available version of PV3D in some BBS
  28.  
  29.     CAD CONNECTION BBS in france
  30.     33 1 39 52 98 54 (2400-14400 8 Bits No parity 1 stop bit)
  31.     GRAPHICS ALTERNATIVE BBS in el Cerrito, CA
  32.     1 510 524 2780   (2400-14400 8 Bits No parity 1 stop bit)
  33.  
  34. o News functions Since the version 1.00 :
  35. ============================================================================
  36.  
  37. PV3DB191
  38.   05-10-1993
  39.     Now PV3D generate POVRAY 2.00 (only) and VIVID 2.00 output
  40.  
  41.     CSG available with groupe                   (POVRAY 2.0 feature)
  42.     Colors and texture support for one groupe   (POVRAY 2.0 feature)
  43.     Colors or texture support in CSG structure. (POVRAY 2.0 feature)
  44.  
  45.     Smoothed triangles in CSG or groupe available trought PV3D2POV
  46.  
  47.     VIVID  2.00 output support
  48.         Just for some primitive sphere, cone, cylindre, plane
  49.         TXT/RAW file ...
  50.         No groupe and CSG support
  51.         External VIVID texture librairie support
  52.             {right} mouse in 'Vivid_2.0' icone .
  53.         External VIVID shape librairie support
  54.             {right} mouse in 'SDF' icone .
  55.  
  56.         VID subdirectory to store the VIVID.vo  2.0 Shapes files
  57.         and VIVID.vs textures files.
  58.  
  59.     Test the TXT/RAW shape and supress the degenerate triangle before POV
  60.     or VIVID script generation.
  61.  
  62.     PV3D2POV.EXE  V2.00   (in the POV subdirectpry)
  63.  
  64.         Read POV or VIVID input file and generate POVRAY 2.00
  65.         POVRAY 1.0 or VIVID 2.00 output file with smoothed or patched
  66.         triangles.
  67.  
  68.     Use of the MSC 8.00
  69.     Some bugs fixed
  70.  
  71. PV3DB181
  72.   05-09-1993
  73.     Mouse bug fixed
  74.     New function bug fixed
  75.     Some bugs fixed
  76.  
  77.  
  78. PV3DB180
  79.   07-04_1993 many news functions
  80.  
  81.      French documentation (110 pages)
  82.      Include mapping bumpping functions with some options (POSTER
  83.      autoscale, once, ...)
  84.         MAP subdirectory to store the GIF TGA files for mapping/Bumpping
  85.      External POV textures libraries
  86.         POV.pit files in the MAP subdirectory
  87.      Fast draw mode
  88.         {Right} mouse on the 'Draw' icone.
  89.      Test the file before open to save
  90.         Replace file ? message box iif the file allready exist.
  91.      All menu with mouse support
  92.      New colors menu
  93.      GIF viewer  for mapping and bummping function.
  94.      Height Field support (GIF only)
  95.      New R-M-S menu
  96.      New GUI look
  97.      XMS support (12000 triangles) HIMEM.SYS or other XMS drivers is
  98.      necessary now to run PV3D.
  99.      Some bugs fixed
  100.      And more ...
  101.  
  102. PV3DV100  Fix scale error in some menu
  103.       Fix and input a new function in R-M-S menu
  104.       Fix the plane POV generation error
  105.       Input limitation for the no registered version
  106.         MAX 100 shapes in a POV files. 195 in registered
  107.         MAX 10 frames in animation. DOS limit in registered.
  108.  
  109. PV3DB62
  110.  03-14-1993 Fix some 3D view error and new 3D view interface
  111.         3D view with multiframe for animation
  112.         New animation function implemented
  113.         Multi frame
  114.         Duplicate function
  115.         Morphe function
  116.          EFFect library for animation
  117.          VALue  library for animation
  118.         SHA Extra POV primitive library implemented
  119.         Alpha color implemented
  120.         POV animation file implementation
  121.         PV3D now is a FreeWare
  122.  
  123. PV3DV060
  124.  02-02-1993 Fix the 'delete' error
  125.         New Groupe function , to use the composite function of POVRAY
  126.         PV3D OBject Library implementation  POB files
  127.         CSG Contructive Solide Geometry support
  128.         Multiple Blob structure
  129.         More Shape, 195
  130.         And some bug fixed
  131.  
  132. PV3DR050
  133.  01-01-1993 Fix the bug in the POV generation file with look_at before right.
  134.  01-02-1993 Generate multi directory for PVD POV TXT PRO file for fast access
  135.         to the file.
  136.         New function 'Path' to select the search path directory for the
  137.         standard file of PV3D. (PV3D.CFG file)
  138.         The standard directory for the PV3D file it is.
  139.  
  140.         PVD\  : for *.PVD *.PVT PV3D scene description file
  141.         TXT\  : for *.TXT triangle file
  142.         POV\  : for the POV and PTX generated file
  143.         IMG\  : for the PV3D texture file
  144.         PRO\  : for the PRO profil file
  145.         TEMP\ : temporary directory used by PV3D in some case
  146.  01-04-1993 Fix the 'New' function with old orbital status
  147.  
  148. PV3DB030
  149.  12-25-1992 New function 'View 3D' for see the scene in 3D with the camera
  150.         and Look_at position.
  151.  
  152. PV3DB021
  153.  12-13-1992 fix big box around the shape with the first loaded shape
  154.         fix Stack overflow  R6000 with the 'SaveTXT' icone
  155.  12-15-1992           
  156.         clean help aera with the  'spline' (PRO) call
  157.         fix the lose of the shape parameter with the load of PRO file
  158.  
  159. √
  160. o PV3D V1.00 files and PV3D B1.91 compatibility
  161. ============================================================================
  162.  
  163. PV3D B1.91 support the PV3D V1.00 files, PV3D B1.91 translate all of the
  164. old PV3D file to a news.
  165.  
  166. o PV3D B1.91 Colors and Textures troubles with old files
  167. ============================================================================
  168.  
  169. With POVRAY 2.00 is possible to assign in a CSG structure one different
  170. color or texture for all shape of the CSG.
  171. With the version V1.00 of PV3D the first color/texture of the CSG structure
  172. define the color/texture of all csg shape. Now is possible to assign different
  173. color/texture in the CSG.
  174.  
  175. WARNING :
  176. Now the first shape of the CSG not define the color/texture of the
  177. CSG. If you want assign the same color/texture for all shape. Create one
  178. PV3D Groupe with no shape color/texture and assign one color/texture for
  179. this groupe when you load this groupe in the master.
  180.  
  181. See the samples file : CHESS2
  182.  
  183.  
  184. o POVRAY 2.00 warning message with PV3D POV files
  185. ============================================================================
  186.  
  187. When you use the mapping or bumpping options PV3D generate a normal vector
  188. direction not fully supported by POVRAY 2.00. This generate one WARNING
  189. during the parsing of the file but it is OK.
  190.  
  191. If one groupe of shape have less then 2 shapes POVRAY generate one warning
  192. but it is OK.
  193.  
  194. o PV3D2POV options
  195. ============================================================================
  196.  
  197. The VIVID 2.00 output replace the PV3D2POV option. Now PV3D generate only
  198. a files with triangle (POVRAY) or polygon (VIVID). If you want smooth or
  199. patch this shape use directly the PV3D2POV V2.00 tools.
  200.  
  201. PV3D2POV sample.pov sample1.pov -s120 -o2
  202. PV3D2POV sample.v sample1.v -s120 -o3
  203.  
  204. Generate the file sample1.pov in POVRAY 2.00 format with all triangle shape
  205. smoothed. (Run PV3D2POV /? for the syntax)
  206. Generate the file sample1.v in VIVID 2.00 format with all triangle shape
  207. patched. (Run PV3D2POV /? for the syntax)
  208.  
  209. if you want smooth or patch only some TXT/RAW shape of your script change
  210. the name of the shape:
  211.  
  212.     If the first character of the shape name was $ PV3D2POV not
  213.     smooth or patch the shape.
  214.  
  215. Why :
  216.  
  217. PV3D2POV compute only the lignes with \ttriangle or \tpolygon (\t = tab)
  218. for PV3D2POV the triangle or polygon definition is only in one line and
  219. one blank line stop the shape .
  220. If the name of the TXT/RAW shape start with $ PV3D generate the output file
  221. with no \t (\t = tab) and PV3D2POV pass the line during parsing.
  222.  
  223. o Height Field support
  224. ============================================================================
  225.  
  226. When you select one height field shape PV3D load one BOX structure to limit
  227. in a space the height field. The pyramid in a box define the down/up (normal)
  228. of the height field. The Box define the height field limit for all colors
  229. 0->255 if your gif file have only 16 color 0->16 the box limit was not good.
  230. Now with POVRAY 2.00 is possible to use one height field in a CSG structure.
  231. PV3D generate one water_level 0.001 to supress the color 0.
  232.  
  233. o Fast draw mode
  234. ============================================================================
  235.  
  236. {right} on the 'Draw' icone start the fast draw mode.
  237.  
  238.     With the MSC 6.00 compiled code I have some troubles with function
  239.     With the MSC 8.00 compiler the troubles are gone.
  240.  
  241.  
  242. o External POV texture Support
  243. ============================================================================
  244.  
  245. With this version of PV3D is possible to use all POVRAY texture.
  246.  
  247. To create your texture file definition just edite one text file in POVRAY 2.00
  248. syntax.
  249.  
  250.     1 - The name of the file was file.PIT
  251.     2 - The PIT files was in a INC subdirectories
  252.    >>>> 3 - The file name of the file was the same than the texture.
  253.     4 - Only one POVRAY 2.00 texture definition by file.PIT.
  254.  
  255. sample : MUR1.PIT
  256.  
  257. #declare MUR1 =  texture {
  258.    pigment { image_map {gif "brique2.gif" interpolate 2.0 }               }
  259.    normal  { bump_map  { gif "brique4.gif" interpolate 2.0 bump_size 5.0} }
  260.    finish  { phong 0.3 phong_size 72  ambient 0.4 reflection .4           }
  261.   }
  262.  
  263. With this function it is easy to create and use all POVRAY 2.00 texture
  264. trought PV3D.
  265.  
  266. √
  267. o PV3D V1.91  and VIVID 2.00 output
  268. ============================================================================
  269.  
  270. The VIVID 2.00 output include in the version 1.91  of PV3D not support
  271. all of the POVRAY 2.00 output.
  272. This new function is here only to help the VIVID user to create more easely
  273. some VIVID script.
  274. For PV3D in all case you create one POVRAY script and all function of PV3D
  275. was available but when you generate one VIVID script some functions was not
  276. available and generate one PV3D warning message.
  277.  
  278. o What is supported or not by PV3D for the VIVID 2.00 output.
  279. ============================================================================
  280.  
  281. o VIVID Primitive supported :
  282. ============================================================================
  283.  
  284. Sphere
  285. Cylindre X Y Z  (closed by ring)
  286. Cone X Y Z      (closed by ring)
  287. Plane X Y Z
  288. Cube
  289. TXT/RAW file
  290.  
  291. o VIVID Texture and Surface Supported :
  292. ============================================================================
  293.  
  294. All POVRAY color Menu
  295.  
  296.     surface
  297.     {
  298.     diff R G B
  299.     }
  300.  
  301. Only VIVID External texture supported :
  302.  
  303. If you want assign a Texture to the shape use the 'Vivid 2.0' icone with
  304. the right mouse button.
  305. One listbox appear with some external VIVID texture file placed in the
  306. VID subdirectory. PV3D call only the texture.VS file of this directory.
  307. The syntax of the texture.VS file was the same than the VIVID 2.00 texture
  308. definition. Put only one VIVID 2.00 texture definition by file.
  309. Only this type of VIVID external texture was supported by PV3D when you
  310. generate one VIVID script.
  311.  
  312.  
  313. Sample of external VIVID.VS texture file for PV3D :
  314.  
  315. WOODSTIC.VS
  316.  
  317. //      wood stick
  318.  
  319. surf {
  320.     texture {
  321.         pattern noise
  322.         scale 1 0.01 0.01
  323.         terms 2
  324.         surf { diff medium_tan*1.3 shine 20 white }
  325.         surf { diff medium_tan*0.7 shine 30 white }
  326.     }
  327. }
  328.  
  329.  
  330.  
  331. o VIVID Clipping function :
  332. ============================================================================
  333.  
  334. PV3D not support the CSG structure for the VIVID output. I work to implemente
  335. the clip function of VIVID for the futur version.
  336.  
  337. o VIVID and external shape support :
  338. ============================================================================
  339.  
  340. If you want call one VIVID.VO file put your VO file in the VID subdirectory
  341. and press the Right mouse button on the 'SHA' icone.
  342.  
  343. WARNING : PV3D generate one beep and one warning message because the SHA
  344. file was no found. PV3D load one Cube to define the limit of your VIVID.VO
  345. object in the space. For PV3D the reference scale of the VIVID.VO object
  346. loaded was (1 1 1). If your object have not this unit reference you have
  347. some trouble when you see the result of your creation :-)
  348.  
  349. o VIVID and the 3D View_point :
  350. ============================================================================
  351.  
  352. PV3D use some POVRAY computation to display the 3D_View function. With the
  353. VIVID output the representation was not correct. I work for that (futur
  354. version)
  355.  
  356. O VIVID and Groupe stategy :
  357. ============================================================================
  358.  
  359. PV3D no support the PV3D groupe stategy with the VIVID output.
  360.  
  361.  
  362. Vivid use the right hand coordinate system but PV3D use the the POVRAY
  363. system !! When PV3D generate the VIVID script PV3D compute all transformation
  364. but all coordinate information displayed to the screen (mouse coordinate) are
  365. for POVRAY.
  366.  
  367. POVRAY     VIVID
  368.  
  369. X          -Z
  370. Y           X
  371. Z           Y
  372.  
  373.  
  374. PV3D Contribution Order
  375. ──────────────────────────────────────────────────────────────────────────────
  376.  
  377. Freeware condition of PV3D
  378. ───────────────────────────
  379.  
  380. PV3D it is a Freeware software only for no commercial use. 
  381. We encourage you to freely copy and distribute this not registered 
  382. demonstration version. 
  383. No part of this package may be included as part of a commercial package 
  384. without My explicit written permission .
  385.  
  386. Sorry but  this version of PV3D it is a very early version, so it might not
  387. bug-free. I work for bug-free and new feature.
  388.  
  389. This is a freeware version of PV3D  and it's not fully functional
  390.  
  391. If you want receive :
  392.  
  393.     ■ PV3D last available full registered version
  394.  
  395.       send to me your contribution for the developpement of PV3D
  396.       For France 250FF Check ( Pour la France )
  397.       For US and other $55. Bank check, Traveller check or
  398.       International Postal order.
  399.     
  400.       (Postal order is very long, about 1 month for USA <-> France).
  401.       Sorry for the delai but it is one French postal problem.
  402.       
  403.       Lecointe Ludovic
  404.       16 rue du Bouvreuil
  405.       77240 Cesson la Forêt
  406.       France
  407.  
  408.       In your Mail say to me where are you found PV3D. If it is one BBS
  409.       Please write me the number phone of this BBS. Thank You.
  410.  
  411.       Post to me one E-MAIL with the PCGNET link and I receive this
  412.       with CAD Connection in France.
  413.       CAD Connection  (33) 1 39 52 98 54  ID: LUDOVIC LECOINTE (prefered)
  414.       PCGNET connection
  415.       Some time (1/2 by month) I connect The Graphics Alternative BBS
  416.       (510) 524 2780 ID: LUDOVIC LECOINTE
  417.  
  418.  
  419. Legal Stuff
  420. ──────────-
  421.  
  422.    This software is provided as is without any guarantees or warranty.
  423.    Although the authors have attempted to find and correct any bugs in
  424.    the package, they are not responsible for any damage or losses of any
  425.    kind caused by the use or misuse of the package. The authors are
  426.    under no obligation to provide service, corrections, or upgrades
  427.    to this package.
  428.    Some menu, icone, function, file format ... are subject to change in a
  429.    futur version.
  430.  
  431.    No part of this package may be included as part of a commercial package
  432.    without My explicit written permission .
  433.  
  434.  
  435. o Exploitation du Logiciel :
  436. ============================
  437.  
  438. Tous les logiciels constituant PV3D,  les fichiers annexes et la documentation
  439. ou les documentations qui les accompagnent quel que soit la version, sont
  440. fournis dans l'état ou ils se trouvent et sans aucune garantie.
  441. Il n'y a aucune garantie d'aucune sorte concernant l'emploi ou les résultats
  442. découlant de l'emploi du ou des logiciels constituant PV3D et de sa ou ses
  443. documentations.
  444. Tous risques afférents aux résultats, performances du produit sont supportés
  445. par l'utilisateur. Ni moi ni qui que ce soit d'autre ayant participé ou non
  446. à la création du produit ne pourra être tenu responsable de tout dommage
  447. direct, indirect, secondaire ou accessoire découlant de l'utilisation ou de
  448. l'impossibilité d'utilisation du produit,  même si j'ai ou nous avons été
  449. informé de tels dommages.
  450. Je ne suis pas tenu ainsi que mes ayant droit d'apporter une aide quelconque
  451. dans l'utilisation, l'installation, le suivi ou la mise à jour du produit
  452. quel que soit sa version.
  453. Je ne suis pas tenu ainsi que mes ayant droit d'apporter des modifications,
  454. mises à jours, correction du produit quel que que soit sa version.
  455. Les caractéristiques,  réglements d'utilisations et de fonctionnement
  456. de PV3D ne peuvent être modifiés que par moi même, sans aucun accord ou
  457. information préalable.
  458. Le fait de participer financiérement ou non au developpement de PV3D ne
  459. modifie en rien les termes de ce paragraphe et ne donne aucun droit d'aucune
  460. sorte sur le logiciel dans son ensemble.
  461.  
  462. L'utilisation ou la diffusion de PV3D implique un plein accord avec les termes
  463. contenus dans ce document quel que soit la langues et le pays d'utilisation ou
  464. de non utilisation du produit.
  465.  
  466.  
  467.  
  468. O PV3D Diffusion :
  469. ==================
  470.  
  471.  
  472. PV3D est un FREEWARE qui peut être diffusé copié librement sur tous supports
  473. informatiques sauf information contraire indiquée par moi même ou sur simple
  474. demande de ma part. Il est interdit de diffuser, copier PV3D sans ce fichier
  475. et tous les fichiers constituant le produit PV3D décrit aux lignes suivante.
  476. La version FREEWARE de PV3D est constituée d'un fichier archive contenant
  477. la totalité des fichiers constituant le logiciel dans sa version FREEWARE.
  478. La syntaxe de ce fichier est PV3DYXXX.ZIP ou
  479.  
  480.     Y   prend la valeur V pour version et B pour Béta
  481.     XXX est le numéro de la version X.XX
  482.     Par exemple PV3DB180.ZIP correspond au logiciel PV3D en format
  483.     archivé dans sa version 1.80 béta.
  484.  
  485.     +   Il est interdit de diffuser les versions Bétas sans mon accord
  486.     +   préalable.
  487.  
  488. Il est interdit de renommer ce fichier archive.
  489.  
  490. Tous les autres fichiers archives ou non concernant PV3D et réalisés par
  491. moi ne peuvent être diffusés copiés qu'avec ma permission écrite.
  492. Les Fichiers PV3D2IMG.ZIP et PV3D_IMG.ZIP contenant les fichiers IMG de
  493. représentation des textures standard de POV par exemple ne font pas partie
  494. du fichier PV3DYXXX.ZIP et ne peuvent pas être diffusés.
  495.  
  496. Il est formellement interdit de diffuser par quelque moyen que ce soit
  497. les noms et numéros de participation des utilisateurs ayant participé
  498. financiérement ou non au développement de PV3D.
  499. PV3D reste dans tous les cas ma propiété et est 'copyrighted'. Les participants
  500. au développement de PV3D n'ont aucun droit autre que celui d'utiliser ou de ne
  501. pas utiliser le logiciel .
  502. Il est interdit de vendre ou revendre PV3D ou une partie de PV3D . Il est
  503. interdit d'inclure PV3D ou une partie de PV3D dans un package commercial
  504. ou non sans ma permission écrite.
  505. Les sociétés, associations et autres de diffusion de logiciel FREEWARE ou
  506. autres ne peuvent pas vendre ou revendre PV3D plus de 10$ ou l'équivalent en
  507. monnaie de leur pays quel que soit le nombre et le format du ou des médias
  508. utilisés pour diffuser PV3D , cette somme incluant les frais de
  509. gestion, expédition et autres de leurs services.
  510. Ces sociétés , associations de diffusion de logiciel FREEWARE ou autre
  511. doivent cesser de diffuser PV3D et les fichiers annexes à PV3D sur simple
  512. demande de ma part.
  513. Les résultats des travaux effectués avec PV3D sont la propriété des ou du
  514. créateur des travaux réalisés avec PV3D et ils en disposen comme bon leur
  515. semble.
  516. On entend par résultat de travaux les fichiers générés à travers les
  517. différentes fonctions de PV3D.
  518.  
  519.  
  520. L'utilisation ou la diffusion de PV3D implique un plein accord avec les termes
  521. contenus dans ce document quel que soit la langues et le pays d'utilisation ou
  522. de non utilisation du produit.
  523.  
  524.